Amazon Pay弊社お支払い画面の利用について
アドレス帳ウィジェット・お支払い方法ウィジェットについて、
加盟店様は実装せずに弊社が提供している画面をご利用いただくことも可能です。
こちらを利用する場合は画面遷移やAPIが変わりますので、以下を参照の上、実装してください。
アドレス帳ウィジェット・お支払い方法ウィジェットについて、
加盟店様は実装せずに弊社が提供している画面をご利用いただくことも可能です。
こちらを利用する場合は画面遷移やAPIが変わりますので、以下を参照の上、実装してください。
画面遷移のイメージを以下に記載します。
弊社画面に遷移してAmazonログイン後(既にAmazonログインしている場合は省略可)、アドレス帳ウィジェット、お支払い方法ウィジェットを選択し、決済を行います。
各操作を行った際の取引状態の遷移です。
「-」は、該当する結果、もしくは操作がないことを表しています。
操作 | 操作結果 | 操作前の状態 | 操作後の状態 |
---|---|---|---|
取引登録 | - | - | 未決済 |
決済実行 | 成功 | 未決済 | 要求成功 |
失敗 | 未決済 | ||
支払手続き開始IFの呼び出し | 成功 | 要求成功 | 認証処理中 |
失敗 | 要求成功 | ||
お客様がお支払い方法選択画面で支払方法、住所を選択し決済 | 成功 | 認証処理中 | 仮売上/即時売上受付/即時売上 |
失敗 | 決済失敗 |
||
お客様がお支払い方法選択画面で決済をキャンセル | 成功 |
決済失敗 | |
失敗 | 認証処理中 | ||
実売上 | 成功 | 仮売上 | 実売上/売上受付 |
失敗 | 仮売上 | ||
キャンセル | 成功 | 仮売上/実売上/即時売上 | キャンセル/返品/返品受付 |
失敗 | 仮売上/実売上/即時売上 (キャンセル実施前の状態) |
||
キャンセル(一部返金) | 成功 | 実売上/即時売上 | 実売上/即時売上/返品/返品受付 |
失敗 | 実売上/即時売上 | ||
当サービスによるAmazon Payとの同期処理(※1) | - | 即時売上受付/売上受付/返品受付 | 即時売上/実売上/返品 |
決済の流れを以下に記載します。
Amazon Payのログイン処理、及びアドレス帳ウィジェット・お支払い方法ウィジットの表示を弊社にて行います。
フローの説明
・弊社お支払い方法選択画面を利用する場合、Amazonセラーセントラルの「JavaScriptの種類」及び「リダイレクトURL」には以下を追加してください。
項目名 | 説明 |
---|---|
JavaScriptの種類 | https://(弊社ドメイン)/ |
リダイレクトURL | https://(弊社ドメイン)/payment/AmazonpayWidget.idPass |
これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。
ShopID | shopID |
必須
半角英数13桁
ショップID |
||
---|---|---|---|---|
ShopPass | shopPass |
必須
半角英数64桁
ショップパスワード |
||
OrderID | orderID |
必須
半角英数記号27桁
オーダーID加盟店様が取引を識別するための値を設定します。 |
||
JobCd | jobCd |
必須
半角英字7桁
処理区分 AUTH:仮売上 |
||
Amount | amount |
必須
半角数字7桁
利用金額税送料を指定した場合は、利用金額 + 税送料が決済金額となります。 |
||
Tax | tax | 半角数字7桁
税送料 |
||
AmazonpayType | amazonpayType |
必須
半角数字1桁
AmazonPay実装タイプ「2」を設定してください。 |
/payment/EntryTranAmazonpay.json
{
"shopID":"tshop11223344",
"shopPass":"PASSWORD",
"orderID":"ORDER0000001",
"jobCd":"AUTH",
"amount":"1000",
"amazonpayType":"2"
}
/payment/EntryTranAmazonpay.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&JobCd=AUTH&Amount=1000&AmazonpayType=2
{
"accessID": "a6a6b0061347e90cdef806b39bd28705",
"accessPass": "5e0e54b892e14ed03e8cf807a6053813"
}
AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813
[
{
"errCode":"E01",
"errInfo":"E01040001"
}
]
ErrCode=E01&ErrInfo=E01040001
これ以降の決済取引で必要となるトークンを返却します。
ShopID | shopID |
必須
半角英数13桁
ショップID |
||
---|---|---|---|---|
ShopPass | shopPass |
必須
半角英数64桁
ショップパスワード |
||
AccessID | accessID |
必須
半角英数32桁 固定
取引ID【取引登録】で発行された値を設定します。 |
||
AccessPass | accessPass |
必須
半角英数32桁 固定
取引パスワード【取引登録】で発行された値を設定します。 |
||
OrderID | orderID |
必須
半角英数記号27桁
オーダーID【取引登録】で指定した値を設定します。 |
||
ClientField1 | clientField1 | 全半角100バイト
加盟店自由項目1 |
||
ClientField2 | clientField2 | 全半角100バイト
加盟店自由項目2 |
||
ClientField3 | clientField3 | 全半角100バイト
加盟店自由項目3 |
||
RetURL | retURL |
必須
半角英数記号256桁
決済結果戻しURL加盟店様が当サービスからの決済結果を受信する為の結果受信URLを設定します。 |
||
PaymentTermSec | paymentTermSec | 半角数字5桁
支払開始期限秒お客様が【決済実行】から【支払手続き開始】を呼び出すまでの期限です。 |
||
ItemName | itemName | 全半角文字記号64桁
商品名【支払手続き開始】で遷移する画面上に表示する商品名を設定します。 |
/payment/ExecTranAmazonpay.json
{
"shopID":"tshop11223344",
"shopPass":"PASSWORD",
"orderID":"ORDER0000001",
"accessID":"a6a6b0061347e90cdef806b39bd28705",
"accessPass":"5e0e54b892e14ed03e8cf807a6053813",
"retURL":"https://example.com/receive"
}
/payment/ExecTranAmazonpay.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&RetURL=https://example.com/receive
AccessID | accessID | 半角英数32桁 固定
取引ID【決済実行】呼出時に指定した値を返却します。 |
||
---|---|---|---|---|
Token | token | 半角英数64桁 固定
トークンアクセスIDのハッシュ値を返却します。 |
||
StartURL | startURL | 半角英数記号256桁
支払手続き開始のURL支払手続き開始のURLを返却します。 |
||
StartLimitDate | startLimitDate | 半角数字14桁 固定
支払開始期限日時支払手続き開始の呼び出し期限を返却します。 |
{
"accessID":"84636abd0bb03500ffce1e1a78deb1b2",
"token":"qlxcMlmNXu+YJoAPr0zIiHoG/KrcaJJkTVUEeuYe67E3Vh427rKZBJphG0D2YhAL",
"startURL":"https://x01.mul-pay.jp/payment/AmazonpayStart.idPass",
"startLimitDate":"20190225162711"
}
AccessID=84636abd0bb03500ffce1e1a78deb1b2&Token=qlxcMlmNXu+YJoAPr0zIiHoG/KrcaJJkTVUEeuYe67E3Vh427rKZBJphG0D2YhAL&StartURL=https://x01.mul-pay.jp/payment/AmazonpayStart.idPass&StartLimitDate=20190225162711
[
{
"errCode":"E01",
"errInfo":"E01040001"
}
]
ErrCode=E01&ErrInfo=E01040001
お客様の表示画面を弊社画面へリダイレクトします。
AccessID | accessID |
必須
半角英数32桁 固定
取引ID【取引登録】で発行された値を設定します。 |
||
---|---|---|---|---|
Token | token |
必須
半角英数64桁 固定
トークン【決済実行】で発行された値を設定します。 |
||
AmazonAccessToken | amazonAccessToken |
半角英数字記号200桁
Amazonアクセストークン加盟店様サイトで既にAmazonログインしている場合、ログイン後に発行されたaccess_tokenを設定します。 |
/payment/AmazonpayStart.idPass
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-31J">
</head>
<body OnLoad='OnLoadEvent();'>
<form name="AmazonpayRedirectCall" action="{接続先URL}" method="POST">
<noscript>
<br>
<br>
<center>
<h2>AmazonPayの決済画面へ遷移します。 </h2>
<input type="submit" value="続行">
</center>
</noscript>
<input type="hidden" name="AccessID" value="{AccessID}">
<input type="hidden" name="Token" value="{Token}">
</form>
<script >
<!--
function OnLoadEvent() {
document.AmazonpayRedirectCall.submit();
}
//-->
</script>
</body>
</html>
リダイレクト後、以下の画面を表示します。(入力パラメータにAmazonAccessTokenを設定した場合は当画面はスキップします。)
ボタンをクリックするとAmazonログイン画面に遷移します。
Amazonログイン画面を表示します。(入力パラメータにAmazonAccessTokenを設定した場合は当画面はスキップします。)
Amazonアカウントのメールアドレス、パスワードを入力しログインします。
ログインしたAmazonアカウントに登録されている住所情報、クレジットカード情報を表示します。
弊社管理画面にて設定を変更することにより、住所情報は非表示にすることが可能です。
※詳細はAmazon Pay管理画面マニュアル を参照ください。
「購入する」をクリックすると決済を行います。
「中止する」をクリックすると対象取引は決済失敗となります。やり直す場合は別オーダーIDで再度【取引登録】から行ってください。
当サービスは、お客様が支払操作を完了または中止した際に、決済実行時に指定された決済結果戻しURLに結果を通知します。
この決済結果は、決済ウィジェット画面からブラウザ経由で連携されるため、ユーザの操作方法によっては支払操作が完了したにもかかわらず、加盟店様に通知されないことがあります。
その際はショップ管理画面、結果通知、決済状態照会にてご確認ください。また、同様の理由でこの決済結果が複数回加盟店様に通知されることがあります。
ShopID | shopID |
半角英数13桁
ショップID |
||
---|---|---|---|---|
OrderID | orderID |
半角英数記号27桁
オーダーID対象取引のオーダーIDを返却します。 |
||
Status | status |
現状態該当取引の取引状態を返却します。 |
||
TranDate | tranDate |
半角数字14桁 固定
処理日時当サービスで処理を実施した日時を返却します。 |
||
AmazonOrderReferenceID | amazonOrderReferenceID |
半角英数19桁
AmazonオーダーリファレンスIDAmazonで取引を特定するためのIDを返却します。 |
||
CheckString | checkString |
半角英数32桁
改ざんチェック文字列OrderID、AccessID、ShopID、ShopPassを連結しMD5ハッシュした値を返却します。 |
※画面リダイレクトのため、決済エラー以外はエラーコードは返却しません。